home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Sharing Fun! I Know My Savior Lives / Sunday Savers: Sharing Fun! I Know My Savior Lives.iso / mac / Xtras / Buddy API 3.7 / Buddy API Docs.swf / texts / 1662.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  3.4 KB  |  141 lines
  1. 165
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. FindWindow 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baFindWindow returns the handle of a window. This handle can then be used in 
  20. --- RECORDSEPARATOR ---
  21. other window management functions.
  22. --- RECORDSEPARATOR ---
  23.  
  24. --- RECORDSEPARATOR ---
  25. Usage:
  26. --- RECORDSEPARATOR ---
  27.  
  28. --- RECORDSEPARATOR ---
  29. Result = baFindWindow( Class/Creator, Title )
  30. --- RECORDSEPARATOR ---
  31.  
  32. --- RECORDSEPARATOR ---
  33. Arguments:
  34. --- RECORDSEPARATOR ---
  35.  
  36. --- RECORDSEPARATOR ---
  37. String, String. 
  38. --- RECORDSEPARATOR ---
  39. On
  40. --- RECORDSEPARATOR ---
  41.  Windows
  42. --- RECORDSEPARATOR ---
  43. , Class is the class name of the window. 
  44. --- RECORDSEPARATOR ---
  45. On
  46. --- RECORDSEPARATOR ---
  47.  Macintosh
  48. --- RECORDSEPARATOR ---
  49. , Creator it is the creator type of the application. 
  50. --- RECORDSEPARATOR ---
  51. Title is the text in the window's caption. 
  52. --- RECORDSEPARATOR ---
  53. The function can use either or both arguments. If one of the arguments is empty, 
  54. --- RECORDSEPARATOR ---
  55. then only the other argument will be used in searching for the window.
  56. --- RECORDSEPARATOR ---
  57.  
  58. --- RECORDSEPARATOR ---
  59. Returns:
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. Integer. 
  64. --- RECORDSEPARATOR ---
  65. Returns the window handle. I
  66. --- RECORDSEPARATOR ---
  67. f the window isn't found, then returns 0.
  68. --- RECORDSEPARATOR ---
  69.  
  70. --- RECORDSEPARATOR ---
  71. Examples:
  72. --- RECORDSEPARATOR ---
  73.  
  74. --- RECORDSEPARATOR ---
  75. Director: 
  76. --- RECORDSEPARATOR ---
  77. set WinHandle = baFindWindow( "" , "Calculator" ) --
  78. --- RECORDSEPARATOR ---
  79.  Windows
  80. --- RECORDSEPARATOR ---
  81.  
  82. --- RECORDSEPARATOR ---
  83. set WinHandle = baFindWindow( "CARO", "" ) 
  84. --- RECORDSEPARATOR ---
  85. --
  86. --- RECORDSEPARATOR ---
  87.  Macintosh
  88. --- RECORDSEPARATOR ---
  89.  
  90. --- RECORDSEPARATOR ---
  91. Authorware: 
  92. --- RECORDSEPARATOR ---
  93. WinHandle := baFindWindow( "" , "Calculator" )
  94. --- RECORDSEPARATOR ---
  95.  
  96. --- RECORDSEPARATOR ---
  97. Notes:
  98. --- RECORDSEPARATOR ---
  99.  
  100. --- RECORDSEPARATOR ---
  101. On
  102. --- RECORDSEPARATOR ---
  103.  Windows
  104. --- RECORDSEPARATOR ---
  105. , a window handle is an number that Windows uses to identify 
  106. --- RECORDSEPARATOR ---
  107. windows. Every window has a unique handle. You can use this handle to 
  108. --- RECORDSEPARATOR ---
  109. manipulate the window; bring it to the front, close it, etc. 
  110. --- RECORDSEPARATOR ---
  111. Every window also has a class name. This is assigned by the programmer, and can 
  112. --- RECORDSEPARATOR ---
  113. be used to find a specific window. For example, the Class window for the main MS 
  114. --- RECORDSEPARATOR ---
  115. Word window is "OpusApp". To find the handle for the Word window, you could 
  116. --- RECORDSEPARATOR ---
  117. use FindWindow( "OpusApp", "" ). 
  118. --- RECORDSEPARATOR ---
  119. If you know the text in the window's caption, you can use this to find the window. 
  120. --- RECORDSEPARATOR ---
  121. For example, FindWindow( "" , "Notepad - mydoc.txt" ). 
  122. --- RECORDSEPARATOR ---
  123. On
  124. --- RECORDSEPARATOR ---
  125.  Macintosh
  126. --- RECORDSEPARATOR ---
  127. , the window handle returned is the identifier for the application rather 
  128. --- RECORDSEPARATOR ---
  129. than an individual window. The title of the window will be the name that appears in 
  130. --- RECORDSEPARATOR ---
  131. the Application menu.
  132. --- RECORDSEPARATOR ---
  133.  
  134. --- RECORDSEPARATOR ---
  135. See also:
  136. --- RECORDSEPARATOR ---
  137.  
  138. --- RECORDSEPARATOR ---
  139. baWindowList 
  140. --- RECORDSEPARATOR ---
  141. baGetWindow